Microsoft DirectX 8.1 (C++)

IAMTimeline::ValidateSourceNames

The ValidateSourceNames method validates source names in the timeline, using the media locator. Optionally, this method also updates any source object for which it locates a file.

Syntax

HRESULT ValidateSourceNames(
    long ValidateFlags,
    IMediaLocator *pOverride,
    long NotifyEventHandle
);

Parameters

ValidateFlags

Bitwise combination of File Name Validation Flags specifying the behavior of the media locator. The SFN_VALIDATEF_REPLACE and SFN_VALIDATEF_CHECK flags must be present, or the method returns E_INVALIDARG.

pOverride

Optional pointer to the IMediaLocator interface of a media locator to use in place of the default. To use the default media locator, set the value of this parameter to NULL. See Remarks for more information.

NotifyEventHandle

Handle to an event. The method signals the event after it has completed the validation.

Return Value

Returns S_OK if successful. Otherwise, returns E_INVALIDARG or another error code.

Remarks

Using the pOverride parameter, you can supply your own custom implementation of the IMediaLocator interface. For example, the default media locator will not notify your application about the files that it finds (or cannot find). To get around this limitation, you could implement a custom media locator, making it a wrapper for the default version. In your custom version, pass IMediaLocator::FindMediaFile calls directly to the default version, and examine the return value.

See Also